---
title: Déployer votre site Astro
description: Comment déployer votre site Astro sur le web.
sidebar:
  label: Vue d'ensemble du déploiement
i18nReady: true
---

import DeployGuidesNav from '~/components/DeployGuidesNav.astro';
import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'
import { Steps } from '@astrojs/starlight/components'

**Prêt à compiler et déployer votre site Astro ?** Suivez l'un de nos guides sur les différents services de déploiement, ou faites défiler vers le bas pour avoir des conseils généraux sur comment le déploiement d'un site Astro.

## Guide de déploiement

<DeployGuidesNav />

## Options de déploiement rapide

Vous pouvez compiler et déployer rapidement un site Astro vers de nombreux hébergeurs à l'aide de l'interface utilisateur du tableau de bord de leur site web ou d'une CLI.

### Interface utilisateur du site web

Une façon rapide de déployer votre site web est de connecter le dépôt Git (p. ex. GitHub, GitLab, Bitbucket) de votre projet Astro à un hébergeur, afin de profiter du déploiement continu en utilisant Git.

Ces hébergeurs détectent automatiquement les push sur le dépôt de votre projet Astro, compilent votre site et le déploient sur le web sur une URL personnalisée ou sur votre nom de domaine personnel. Souvent, la configuration d’un déploiement sur ces plateformes suivra des étapes similaires à celles-ci :

<Steps>
1. Ajoutez votre dépôt à un fournisseur Git (p. ex. sur GitHub, GitLab, Bitbucket)

2. Choisissez un hébergeur qui prend en charge le *déploiement continu* (p. ex. [Netlify](/fr/guides/deploy/netlify/) ou [Vercel](/fr/guides/deploy/vercel/)) et importez votre dépôt Git en tant que nouveau projet / site.

    De nombreux hébergeurs vont reconnaître votre projet en tant que site Astro, et devraient automatiquement appliquer la configuration appropriée pour compiler et déployer votre site comme montré ci-dessous. (Dans le cas contraire, ces paramètres peuvent être modifiés.)

    :::note[Paramètres de déploiement]
    - **Commande de compilation :** `astro build` ou `npm run build`
    - **Dossier de publication :** `dist`
    :::

3. Cliquez sur « Déployer » et votre nouveau site web sera créé avec une URL unique (p. ex. `nouveau-site-astro.netlify.app`).
</Steps>

L'hébergeur sera automatiquement configuré pour surveiller les modifications apportées à la branche principale de votre fournisseur Git, et pour recompiler et republier votre site à chaque nouveau commit. Ces paramètres peuvent généralement être configurés dans l'interface utilisateur du tableau de bord de votre hébergeur.

### Déploiement via une CLI

Certains hébergeurs proposent leur propre interface en ligne de commande (CLI) que vous pouvez installer globalement sur votre machine en utilisant npm. Souvent, utiliser une CLI pour déployer ressemble à ceci :

<Steps>
1. Installez globalement la CLI de votre hébergeur, par exemple :

    <PackageManagerTabs>
        <Fragment slot="npm">
        ```shell
        npm install --global netlify-cli
        ```
        </Fragment>
        <Fragment slot="pnpm">
        ```shell
        pnpm add --global netlify-cli
        ```
        </Fragment>
        <Fragment slot="yarn">
        ```shell
        yarn global add netlify-cli
        ```
        </Fragment>
    </PackageManagerTabs>

2. Exécutez la CLI et suivez les instructions de connexion, mise en place etc.

3. Compilez votre site et déployez-le sur votre hébergeur

    De nombreux hébergeurs vont reconnaître votre projet en tant que site Astro, et devraient automatiquement appliquer la configuration appropriée pour compiler et déployer votre site comme montré ci-dessous. (Dans le cas contraire, ces paramètres peuvent être modifiés.)

    :::note[Paramètres de déploiement]
    - **Commande de build :** `astro build` ou `npm run build`
    - **Dossier de publication :** `dist`
    :::


    D'autres hébergeurs vont vous demander de [compiler votre site localement](#compiler-votre-site-localement) et déployer en utilisant la CLI.
</Steps>

## Compiler votre site localement

De nombreux hébergeurs comme Netlify ou Vercel vont compiler votre site pour vous puis le publier. Mais, certains sites vous demanderont de compiler localement puis d'exécuter une commande de déploiement.

Vous souhaiterez peut-être également compiler votre site localement pour le prévisualiser ou pour détecter d'éventuelles erreurs et avertissement dans votre propre environnement.

Exécutez la commande `npm run build` pour compiler votre site Astro.

<PackageManagerTabs>
      <Fragment slot="npm">
      ```shell
      npm run build
      ```
      </Fragment>
      <Fragment slot="pnpm">
      ```shell
      pnpm run build
      ```
      </Fragment>
      <Fragment slot="yarn">
      ```shell
      yarn run build
      ```
      </Fragment>
  </PackageManagerTabs>

Par défaut, la sortie de compilation sera placée dans `dist/`. Ce dossier peut être modifié en utilisant [l'option de configuration `outDir`](/fr/reference/configuration-reference/#outdir).

## Ajouter un adaptateur pour le rendu à la demande

:::note
Avant de déployer votre site Astro avec le [rendu à la demande](/fr/guides/on-demand-rendering/) activé, vérifiez que vous avez :

- Installé [l'adaptateur approprié](/fr/guides/on-demand-rendering/) en tant que dépendance de votre projet (que ça soit manuellement, ou en utilisant la commande de l'adaptateur `astro add`, p. ex. `npx astro add netlify`).
- [Ajouté l'adaptateur](/fr/reference/configuration-reference/#integrations) à votre fichier `astro.config.mjs` si vous installez manuellement. (La commande `astro add` fera cette étape automatiquement !)
:::
